
    <!DOCTYPE html>
    <html lang="zh-CN">
    <head>
      <meta charset="UTF-8">
      <meta name="viewport" content="width=device-width, initial-scale=1.0">
      <title>如何编写清晰可读的提交信息？ - 学习卡片</title>
      <style>
        body { font-family: sans-serif; background-color: #f0f8ff; color: #333; display: flex; flex-direction: column; align-items: center; padding: 50px 20px; }
        .header h1 { font-size: 32px; }
        .grid-container { display: grid; grid-template-columns: repeat(3, 1fr); gap: 28px; width: 100%; max-width: 1200px; }
        .card-container { perspective: 1200px; cursor: pointer; height: 250px; }
        .card { width: 100%; height: 100%; position: relative; transform-style: preserve-3d; transition: transform 0.7s; border-radius: 16px; box-shadow: 0 4px 16px rgba(0,0,0,0.08); }
        .card-container.flipped .card { transform: rotateY(180deg); }
        .card-face { position: absolute; width: 100%; height: 100%; backface-visibility: hidden; display: flex; flex-direction: column; box-sizing: border-box; border-radius: 16px; background-color: #fff; padding: 24px; }
        .card-back { background-color: #f0fff4; transform: rotateY(180deg); justify-content: space-between; }
        .card-category { font-size: 14px; color: #0052d9; margin-bottom: 8px; font-weight: 500; }
        .card-question { font-size: 20px; font-weight: 500; flex-grow: 1; display: flex; align-items: center; justify-content: center; text-align: center; }
        .card-answer-wrapper { flex-grow: 1; overflow-y: auto; }
        .card-answer { font-size: 15px; line-height: 1.7; }
        .card-footer { font-size: 13px; color: #8a919f; border-top: 1px solid #f0f0f0; padding-top: 16px; margin-top: 16px; }
        .card-source { font-size: 13px; color: #8a919f; border-top: 1px solid #f0f0f0; padding-top: 12px; margin-top: 12px; }
      </style>
    </head>
    <body>
      <div class="header">
        <h1>如何编写清晰可读的提交信息？ - 学习卡片</h1>
      </div>
      <div class="grid-container">
        
    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">理论</div>
          <div class="card-question">为什么说清晰规范的 Git 提交信息在项目开发和维护中至关重要？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">理论</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">清晰规范的 Git 提交信息能够：1. 提升协作效率，帮助团队成员快速了解提交目的；2. 帮助代码审查，让审查者快速了解变更上下文；3. 便于后期维护，帮助开发者快速追踪问题来源；4. 提升项目管理，帮助项目经理了解项目进展。</div>
          </div>
          <div class="card-source">来源: 一、提交信息的重要性</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">结构</div>
          <div class="card-question">一个标准的 Git 提交信息通常由哪三个部分组成？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">结构</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">一个标准的 Git 提交信息通常由三部分组成：1. 标题（Subject）：简洁描述提交目的；2. 正文（Body）：详细解释提交的动机和背景；3. 脚注（Footer）：记录关联任务、bug编号或破坏性变更提示等补充信息。</div>
          </div>
          <div class="card-source">来源: 二、提交信息的基本结构</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">规范</div>
          <div class="card-question">编写 Git 提交信息的标题（Subject）时，应遵循哪些主要特点？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">规范</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">一个好的标题应具备三个特点：1. 简洁明了，直接表达核心内容；2. 使用命令式动词，如“修复”、“增加”等，而不是过去式；3. 使用项目相关的术语或关键词。</div>
          </div>
          <div class="card-source">来源: 2.1 标题（Subject）</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">规范</div>
          <div class="card-question">提交信息的正文（Body）部分应该包含哪些核心内容？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">规范</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">正文部分应主要阐明提交的动机和背景，解释为什么这个变更是必要的。如果涉及复杂逻辑，还应详细描述解决方案或思路，以帮助他人理解。</div>
          </div>
          <div class="card-source">来源: 2.2 正文（Body）</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">结构</div>
          <div class="card-question">在什么情况下应该使用提交信息的脚注（Footer）？它通常用来记录什么信息？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">结构</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">脚注通常用于记录额外的补充信息。例如，当提交与特定任务或 bug 相关时，可以记录任务或 bug 编号；如果提交包含破坏性变更（如 API 变动），也应在脚注中注明。</div>
          </div>
          <div class="card-source">来源: 2.3 脚注（Footer）</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">实践</div>
          <div class="card-question">什么是“一次提交一个目的”的最佳实践？为什么要这样做？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">实践</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">“一次提交一个目的”是指每次提交都应专注于一个特定的功能或修复，避免将多个不相关的变更放在同一个提交中。这样做可以让提交信息更清晰，并有助于后期的版本回溯和代码审查。</div>
          </div>
          <div class="card-source">来源: 3.4 一次提交一个目的</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">实践</div>
          <div class="card-question">为什么不建议在开发过程中进行过于频繁的小提交？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">实践</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">过于频繁的提交会导致 Git 提交历史显得凌乱不堪，不利于代码的管理，也会让其他开发者难以理解每个提交的具体内容。建议在完成某个功能后再进行提交。</div>
          </div>
          <div class="card-source">来源: 3.3 避免过于频繁的小提交</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">规范</div>
          <div class="card-question">在编写提交信息时，关于标题和正文的长度，文档中推荐的最佳实践是什么？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">规范</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">为了保持简洁直观，标题部分最好控制在 50 个字符以内，而正文部分则建议每行控制在 72 个字符以内。</div>
          </div>
          <div class="card-source">来源: 3.1 保持简洁且直观</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">实践</div>
          <div class="card-question">在处理复杂问题时，为什么需要在提交信息中包含上下文？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">实践</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">在处理复杂问题时，包含上下文能够让其他开发者理解变更的背景。例如，可以说明为什么选择某种实现方式、是否考虑过其他选择，或者改动是否对其他模块产生影响。</div>
          </div>
          <div class="card-source">来源: 3.5 在提交信息中包含上下文</div>
        </div>
      </div>
    </div>

      </div>
    </body>
    </html>
